package cn.iocoder.yudao.module.erp.service.stocksmove;

import java.util.*;
import jakarta.validation.*;
import cn.iocoder.yudao.module.erp.controller.admin.stocksmove.vo.*;
import cn.iocoder.yudao.module.erp.dal.dataobject.stocksmove.StocksMoveDO;
import cn.iocoder.yudao.module.erp.dal.dataobject.stocksmoveitem.StocksMoveItemDO;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.framework.common.pojo.PageParam;

/**
 * ERP 库存调拨单 Service 接口
 *
 * @author 管理员
 */
public interface StocksMoveService {

    /**
     * 创建ERP 库存调拨单
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createStocksMove(@Valid StocksMoveSaveReqVO createReqVO);

    /**
     * 更新ERP 库存调拨单
     *
     * @param updateReqVO 更新信息
     */
    void updateStocksMove(@Valid StocksMoveSaveReqVO updateReqVO);

    /**
     * 删除ERP 库存调拨单
     *
     * @param id 编号
     */
    void deleteStocksMove(Long id);

    /**
     * 获得ERP 库存调拨单
     *
     * @param id 编号
     * @return ERP 库存调拨单
     */
    StocksMoveDO getStocksMove(Long id);

    /**
     * 获得ERP 库存调拨单分页
     *
     * @param pageReqVO 分页查询
     * @return ERP 库存调拨单分页
     */
    PageResult<StocksMoveDO> getStocksMovePage(StocksMovePageReqVO pageReqVO);

    // ==================== 子表（ERP 库存调拨项） ====================

    /**
     * 获得ERP 库存调拨项列表
     *
     * @param moveId 调拨编号
     * @return ERP 库存调拨项列表
     */
    List<StocksMoveItemDO> getStocksMoveItemListByMoveId(Long moveId);

    /**
     * 新增二级库以及台账
     *
     * @param createReqVO 创建信息
     */
    void createStocksOnMoveItem(@Valid StocksMoveSaveReqVO createReqVO);
}